EventsCli
Section: Misc. Reference Manual Pages (8N)
Index
Return to Main Contents
EventsCli - Command Line Interface for sending alarms to Pep, SNMP, etc
SYNOPSIS
EventsCli
-h host -n name -v measured_value
-u units -q quiet -s severity
-t trap_num -T threshold
-S state -V totalValue
DESCRIPTION
EventsCli
is a user interface to the Events alarm dispatching facilities.
It can be used to send SNMP traps,
notify Pep, and log an event.
These events can be from external processes that call
EventsCli
each time a condition warrents reporting.
The
EventsCli
is intended to be an interface between your existing system monitoring
programs and scripts.
These programs and scripts can call
EventsCli
and then rely upon the SNMP traps,
Events data logging, and Pep to take the
corrective action you desire.
OPTIONS
-
- -h host
-
The hostname the trap references
- -u units
-
The
units
value specifys the unit of measure for the value measured.
- -q quiet
-
EventsCli will not prompt user for confirmation of data.
- -v measured_value
-
The value being reported. This can be any data type including a short string.
- -n name
-
A brief name,
which must be quoted if it contains white space,
could be
a test name,
or other descriptive text.
- -s severity
-
Where severity is a number between a low of 1 and a high of 5.
- -t trap_num
-
Events
has twelve general purpose TRAPs for EventsCli.
These are numbered from 500 to 511.
The trap_num you choose can be arbitrary but
must be within the range indicated.
- -T threshold
-
The name of the threshold exceeded.
This is a very short description of what happened
i.e. "low alarm threshold".
In real life, any brief text is acceptable.
- -S state
-
For setting the state of the trap, ie. "low", "hi", and "ok"
- -V totalValue
-
For specifyinf the total value for event. This variable may be either
a number or a string. Strings with white space must be quoted.
EXAMPLE
EventsCli -n DatabaseA -T "high tps" -u "tps" -v 12345 -s 5 -t 501
This might mean:
(-c)
DatabaseA
is doing (-v)
12345
(-u)
tps
and has exceeded
the (-T)
high tps
threshold.
The event will be reported with the highest
severity level (-s)
5
and will be sent using trap number (-t)
501
RESTRICTIONS
EventsCli
must be invoked on a machine that has AgentMon running.
Index
- SYNOPSIS
-
- DESCRIPTION
-
- OPTIONS
-
- EXAMPLE
-
- RESTRICTIONS
-
This document was created by
man2html,
using the manual pages.
Time: 20:58:06 GMT, November 08, 2022